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PREFACE 



This document is a complete installation and verification package for 
TOPS-20 PASCAL. 

The audience for this document is the system manager or operator, one 
who is familiar with the installation and operation of the system 
software . 

For more information concerning the installation of software, refer to 
the TOPS-20 Softwar e Installation Guid e. 

This document uses the following conventions: 

( rft ) This symbol indicates where you press the 

RETURN key. 

Contrasting Colors Orange - Where examples contain both user 

input and computer output, the characters 
you type are in orange; the characters 
printed on the terminal are in black. 



v 



1.0 Introduction 

This document describes the procedures for installing Version 1 of the 
following software on TOPS-20: 

PASCAL.EXE PASCAL compiler 

PASLIB.REL PASCAL run-time and math library 

PASOTS.EXE PASCAL object-time system 

PASDDT.REL PASCAL debugger 

Note that LINK-20 Version 5.1 and RMS-20 Version 1.2(71), or later, 
are required to run PASCAL Version 1. If you plan to rebuild from 
command files, you also need MAKLIB Version 2.2. 

PASCAL, PASLIB, PASOTS , PASDDT, and .HLP files should be installed on 
SYS: . 

The release is in the form of a 1600 BPI PASCAL distribution tape 
written in TOPS-20 DUMPER format containing five savesets. 



2.0 Contents of the Distribution Tape 

The distribution tape consists of the following savesets: 

1. PASCAL-DOCUMENTATION 

This saveset includes all PASCAL documentation files. 

2. PASCAL-SYSTEM 

This saveset includes the .EXE, .REL, and .HLP files that 
should be installed on SYS:. 

3. PASCAL-TEST 

This saveset includes the UETP tests and the .VER file. It 
also includes a .CTL file that runs the same tests without 
using UETP. 

4. PASCAL-OTS-DEBUGGER 

This saveset includes the .REL files for PASOTS and PASDDT 
and all intermediate files generated when building these .REL 
files . 

5. PASCAL-COMPILER 

This saveset includes the .REL files for the compiler and all 
intermediate files generated when building the compiler. 



3.0 Installing PASCAL 

The following files comprise the PASCAL compiler and object-time 
system. Merely copying these files from the second saveset on the 
distribution tape provides a working PASCAL system. The files are: 

PASCAL. HLP 
PASCAL.EXE 
PASOTS.EXE 
PASLTB.REL 
PASDDT.REL 
PASDDT.HLP 

Perform the following steps to install the PASCAL system: 

^STEP 1 

LOGIN as the operator or as a user with WHEEL privileges. 

^STEP 2 

Type the ENABLE command. 

^STEP 3 

Mount the PASCAL distribution tape. See the TOPS-20 Software 
Installation Guide 



^STEP 4 



Use the BUILD command to create directories for the contents of the 
PASCAL distribution tape. You can use directory names of your choice. 
Type the following commands: 



$build <noc--iji rector «:•■■■ 

$*WORK 100 

$$perm ioo 

*$D I RECTORY group 



•Give directors name of your choice 



! One of your user groups* If nonev 

! ask system manager for a group number 



$ BUILD <RUN-d:i. recto ry> 

$$W0RK 400 

$$E'ERM 400 

**D I RECTORY group 

** C^TT ) 

$ B U 1 1.. D < T E! S T S - d i r e c t o r « > 

**W0RK 200 

* SPERM 200 

$ *D I RECTORY group 

<|>$ (TFT} 



! Same group as above 



! Same group as above 



* B U I !.. L'i < P A S T S - dire c t o r y : 

$$W0RK 400 

**PE:RM 400 

** DIRECTORY group 



•Same group as above 



* B U 1 1. D < C M P I L E: R - d i r e c t o r w > 
**W0RK 000 

$*PERM 800 

* $ D IRE. C T R Y g r o u p ! S a m e g r o u p a s a b o v e 
** CIlD 



^STEP 5 



Use the DUMPER program to restore the files from the distribution tape 
to disk. If you do not want to restore a particular saveset, just 
replace the particular RESTORE command with a SKIP 1 command. Type 
the following : 



*DUMP 
BUMPE 
DUMPE 
DUMPE 
DUMPE 
DUMPE 
DUMPE 
DUMPE 
DUMPE 
DUMPE 
DUMPE 
DUMPE 
DUMPE 



ER 



TAPE 
•REWIN 
•PILE 
•DENS I 
■ACC0U 
•RES TO 
•REST0 
■REST0 
•RES TO 
•RES TO 
•UNL0A 

EXIT 



MTAi-iJ 
[i 



TY 

NT 
RE 
RE 
RE 
RE 
RE 
D 



1600 
SYS 



ps: 
ps : 

PS J 
PS J 



■-. 'r .-■' *r ♦ nS ♦ * 

■*.. *r- .-'' *r * * ♦ 'K 

••. * .■*" *¥■ ♦ * ♦ HP- 

': *P .''' T ♦ Jf ♦ * 



(TO) 
(TO) 
(TO) 
(TO) 
(TO) 



:; D C -■ dire c t o r y > * ♦ * ♦ * 
:! R U N •- d i r e c t o r y > * , # . * 
:: T E S T S ••■■ direct o r y :> *<•*.* 
:: P A S T S •- dire c t o r y > * ♦ * ♦ * 
:: C M P I L. E R •■■■ dire c t o r a > * . * 



^STEP 6 



Follow the "Special Instructions" (if any) at the end of the cover 
letter. Also, read the PASCAL . BWR file in the <DOC-d i rectory) for 
any last minute instructions. 



^STEP 7 

Install the PASCAL system software to SYS 

SCOPY <RUN-d:i. reetory>*»* SVSJ*.* 
* c: P Y < R (J N - dire c t o r a > * . H L l :: ' H I... P : * . * 



by giving the commands 



3.1 System Verification (UETP) 

Perform the following procedures to test the PASCAL system: 

^STEP 1 

Install the PASCAL UETP test module by giving the commands: 

* C P Y < T E S T S - d :i. r e c t o r a ■ ■■ * ♦ * P S I < U E T I" 1 . 1... I B > * . * 

Note to run UETP, you must have OPERATOR privileges, IPCF privileges, 
and be in USER group 100. 



^ STEP 2 

Once the PASCAL system components have been placed on SYS:, (see 
Section 3.0, STEP 7 above) you can run the UETP test module provided 
by giving the following commands: 

* B U I L D P S I < U E T P ♦ P A S C A L > 
♦♦DIRECTORY 100 
♦♦USER 100 
♦♦PERM 200 
**W0RK 200 

* CONNECT PS : <UETP . RUN> 

♦ DEFINE DSKJ DSK : r PS J <UETP ♦ LIB> 
♦DELETE PASCAL . LOG , RUN . LOG , EXCEPT . LOG 
♦RUN UETP 

UETP>ENABLE PASCAL/DEPTH: VERIFICATION 
UETP>BEGIN 

UETP>STATUS ! to £Jet status of Job 
UETP>EXIT 
♦DEFINE DSK: 



NOTE 

If you have not installed the PASCAL 

components on SYS:, you must edit 

PASCAL. VER in PS : <UETP. LIB> to set up 
your SYS: definition. 



If any errors occur, UETP reports them at your terminal and in the 
file EXCEPT.LOG. For more information on UETP, see the UETP 
Procedures/Reference Manual in the TOPS-20 Notebook Set. 



^STEP 3 

If desired, run the standalone PASCAL test module provided. First, 
edit the file P20TST.CMD to set up SYS: and DSK : definitions. Then 
give the following commands: 

* C N N E (!) T < T E S T - dire c t o r w > 
$ DELE IE P20TST.LOG 

* S U B M I T P 2 T ST* C T I... / T I M E * * 2 * 

Note on a KS10 processor, you need /TIME : 25 : 00 . 

When the test batch job is completed, the P20TST.LOG file must be 
examined to make sure that none of the tests branched to the error 
label UERR:. 

^STEP 4 

Run your own tests if desired. 

3.2 Clean-up 

After you have completed testing, you can destroy any directories you 
do not need. For each directory you want to destroy, give the 
following commands: 

$ B I J 1 1... D ■•■:.' n a m e - o f •■■■ dire c tory - 1 o ■■- d e s t r o y > 

KILL 

! GiD TO CONFIRM 

! C^"Q TO EXIT BUILD 

Note that a directory cannot be deleted unless all of its 
subdirectories have been deleted. 



3.3 Building with Autopatch 

When the installation is complete, you may want to set up PASCAL for 
Autopatching . See the TOPS- 10 /TOPS -20 Autopatch Procedures Reference 
Manual , and any PASCAL specific information provided with Autopatch 
documentation files. 



3.4 Building without Autopatch 

If you have the need to make changes to the PASCAL files, you can 
rebuild them by using the command files provided on the tape. 

To build the library PASLIB.REL from PAS2L1.REL, do the following: 

(? C N N < P A S T S -•• d i r e e t o r y > 

GMAKLIB 

*GPAS2L1 *MKL. 

To build PASOTS.EXE, do the following: 

l<> C N N < P A S T S - dire c t o r y > 
(3 LINK 
*(?>PAS201. ,LNK 

(?ge:t pa sots 

l<?SAVE PA SOTS 400 '577 

To build the PASCAL compiler, be sure that PASLIB.REL is on SYS:. 
Then, do the following: 

<? C N N < C M P I L E R - d i r e c t o r y > 

©LINK 

*@PAS2C1.LNK 

©RUN PASCAL. 

©SAVE PASCAL 577 

To build the debugger PASDDT, do the following: 

© C P Y PAS 2 D 1 . R E L. P A S D H T ♦ R E L 
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